Cream of the Crop 12

home *** CD-ROM | disk | FTP | other *** search

/ Cream of the Crop 12 / Cream of the Crop 12 (Part II) / Cream of the Crop 12 (Part II).iso / OS2 / BIRTH211.ZIP / BIRTHDAY.DOC < prev next >

Wrap

Text File | 1996-03-10 | 26.2 KB | 727 lines

Birthday v1.0 10/3/1996 Author: Horacio Jamilis Made in Argentina Birthday - 2 INDEX INTRODUCTION About Birthday .................................... 3 Characteristic .................................... 3 Requirements ...................................... 3 INSTALLATION Decompresion ...................................... 4 Running the installation program .................. 4 UTILIZATION THE COMMAND LINE Syntax ............................................ 5 Example ........................................... 6 THE MAIN WINDOW Elements .......................................... 7 The application menu .............................. 7 The Resume panel .................................. 8 The Record panel .................................. 8 The system menu ................................... 9 The title bar ..................................... 9 The pushbuttons section ........................... 10 Keys summary of the main window ................... 10 EDIT WINDOW The fields ........................................ 11 Available keys .................................... 11 INFORMATION WINDOWS Birthday of the day ............................... 12 Birthday of the week .............................. 12 Birthday of the month ............................. 13 Birthday of the next n days ....................... 13 LEGAL NOTES Commercial character and responsibility of the author ...................................... 14 Trademark ......................................... 14 NOTES OF THE AUTHOR The asking ........................................ 15 Limitations ....................................... 15 The future ........................................ 15 Mistakes and suggestions reports .................. 16 Dedication and gratefulness ....................... 16 How to contact the author ......................... 16 Birthday - 3 INTRODUCTION About Birthday: This program shows the persons that reaches years within a given period. Permit to see who reaches years today, in this week, in this month, or in the next n days (being n among 1 and 180). Characteristic: So much in the birthday lists of the day, of the week or of the month, you can see the corresponding day, week or month, previous or following. In this version only can be loaded until 450 persons by file, having no limit the quantity of files that it can use. The program have a protection system that avoids that you lose the modifications accomplished to the file and not kept in case that the machine is hung. The following time that execute the program, and has this to enter the main window, will give to you the opportunity of recovering the not kept file. The program comes in two versions: Spanish, call Cumpleaños distributed as Cumpl2XX.ZIP English, call BirthDay distributed as Birth2XX.ZIP where XX indicates the number of version. The version 1.0 in Spanish is distributed as Cumpl210.ZIP Requirements: This program requires to operate OS/2 and the minimal requirements of this. It was tested with the version Warp 3.0 red spin, but certainly it must operate with the rest of the versions of Warp (and I don't know with with OS/2 2.1). Birthday - 4 INSTALLATION Decompresion: To this height you must already have the distribution package decompresed. For if chance still not it decompres, get into the subdirectory in the one which wishes to locate Birthday. If it did not exist, use the command MD Dir_Name to create it and then locate in that directory using CD Dir_Name. Once in the subdirectory selected (the one which is not necessary that it is empty) proceed to the decompresion. For this, you needs the file Unzip.EXE from InfoZip that is not distributed in this package. It is required an OS/2 decompressor to maintain the extended attributes of the executable. Type: Unzip X:\Path\Birthday <Enter> being X the unit in the one which is found the package compressed and Path the road toward the package. Once decompressed successfully, you will have the files: BirthDay.EXE (the executable) BirthDay.DOC (this file) BirthDay.CAS (a file of birthday records) and Install.CMD (the REXX program of installation) File_Id.DIZ (description of the program). Running the installation program: Once decompressed the file, execute the installation program typing: Install <Enter> The installation program will ask you if wishes to put an icon of object to enter program in the desktop and also will ask you if wishes to put an icon on the startup group, and in the event of answering affirmatively, you will have to specify with which action (to inform the birthday of the day, of the week, of the month or of the next n days where you will have to specify n). If by any motive are erased these icons, so much of the desktop as of the startup group, reexecute Install to recreate them. The installation is completed. It is not required any type of configuration. Birthday - 5 UTILIZATION - THE COMMAND LINE Syntax: BirthDay [/F:FileName.Ext] [/V:X] [/N:NN] [/D] [/W] [/M] [/?] Use BirthDay without parameters to enter the main window of the program using the default file ("BirthDay.CAS"). To use other file put its name and extension on the parameter /F. To force the appearance of the window, even when there is nobody that reaches years during the period use /V:Y. On the contrary with /V:N force the not appearance of the information window supposing they may not have persons that reaches years in the specified period. This is the default value. To see the persons that reaches years in the next 10 days, use the option /P:10. To see the persons that reaches years today, use the parameter /D. To see the persons that reaches years in this week, use the parameter /S. To see the persons that reaches years in this month, use the parameter /M. To see a simple list of the parameters that admits, use /? or /H. Can be used both upercase and lowercase for the parameters. Can be used the bar ("/") as well as the hyphen ("-") as indicative of parameter. The two points (":") are optional. Also it can use a convination of all of them. Birthday - 6 UTILIZATION - THE COMMAND LINE Example: BirthDay /F:File1.Cas -vy /D /V:N /W -ffile2 -M -P5 /p15 <Enter> first causes that use the file File1.Cas, force the appearance of the information window and then shows the persons that reaches years today among those which are in the file File1.Cas. This window will appear yet if nobody reaches years today. Then force the not appearance of the information window therefore below is fixed if someone reaches or reached years in the current week, and only if there is someone appears the information window showing them also from the file File1.Cas. Then it loads the file file2 (without extension) and shows the persons that reaches years in the current month (if there is not nobody neither appears the window). Finally it revises if there is someone that reaches years today or within the next 5 days and finally search among today and the next 15 days. If the last parameter would be /F:FileName.Ext, it would open the main window of the program using the file FileName.Ext. As could appreciate, the parameters are processed in the order in which are entered. Birthday - 7 UTILIZATION - THE MAIN WINDOW Elements: The main window counts of the following elements: - A system menu (that appears upon presing the icon that is at the left of the title bar); - The title bar (in the central upper part of the window); - The button to minimize the window (at the right of the title bar); - The application menu (immediately under the title bar); - A Resume panel (in the left central part of the window); - A Record panel (in the raight central part of the window); - A pushbuttons sector (in the lower part of the window). The application menu: In the application menu there is two submenus: - File and - BirthDay In the File submenu you have the options: - New: to create a new file. - Open: to open an existing file. - Save: to save the file that it is being using. - Save As: to keep the current file with a new file name. - Product Information: shows the current version of the product. - Exit: close the application. Also you can accede to some of these options using determined convinations of keys in the main window: - Save with Alt+G or Alt+S. - Exit with F3, Alt+X or Alt+F4. In all the cases of convination of keys of the type Alt+X, means that you must press the key ALT, and while maintains it pressed must pulsate the key X. F3 is the third function key. In the BirthDay submenu you have the options: - Day: to obtain a list from the persons of the file that it is opened currently and reaches years today. - Week: to obtain a list from the persons of the file that it is opened currently and reaches years this week. - Month: to obtain a list from the persons of the file that it is opened currently and reaches years this month. - Next days: to obtain a list from the persons of the current file that reaches years among today and n days toward forward, being able to specify n among 1 and 180. Birthday - 8 UTILIZATION - THE MAIN WINDOW Also you can accede to some of these options using determined convinations of keys in the main window: - Day with Ctrl+D. - Week with Ctrl+W. - Month with Ctrl+M. - Next days with Ctrl+N. In all these cases, Ctrl+X means that you must press the key CONTROL, and while is maintained pressed, you press the key X. The resume panel: In the resume panel (in the left central part of the main window), is shown the number of the current record and the total number of records of the opened file. The number always are completed with zeroes to have 3 digits. For example, if in this section appears: 023/126 mean that we are interacting with the record number 23, and that the file that it is being using has 126 records. Below, in this same panel is shown the age of the person of the current record (according to his birth date). The Record panel: In the record panel are shown the data of the current record. The data that are kept in the record are: - The name - The last name - The birth date, split into day, month and year (in this order). Continuing with the example, will show us the information of the record number 23 like this: Names: Juan Andrés Last Name: Lopez Birth Date: 15/06/1990 Birthday - 9 UTILIZATION - THE MAIN WINDOW The system menu: The system menu is the standard menu of the applications of OS/2 PM. Not all its options are available due to the fact that the main window does not permit to change its size. Due to this the options Size, Hide and Maximize are not available. The rest of the options can be used and caused the customary effect. Use Move to move the main window through the screen. Also you can move the window dragging the title bar with the pointer of the mouse or presing Alt+F7. Use Minimize to reduce the window to its minimal size, an icon, the one which will be located in the minimized windows visor, in the desktop or will be hided, according to the form in which it is configured in the Window eyelash in the configuration file of BirthDay to the one which is acceded presing with the mouse right button on the icon of BirthDay and select Values in the emerging menu. Also you can minimize the main window presing with the pointer of the mouse on the icon to minimize (in the extreme superior right to the main window) or presing Alt+F9. Use Close to end the execution of the application. Also you can use, as was explained previously, Alt+F4, F3 or Alt+X. Use Windows List to see the list of the active windows (of this or other programs). Also you can accede to this list presing Ctrl+Esc. The title bar: The title bar contains information of the current operation of the program. The contents of the title bar is the same that identifies this application in the windows list (to which accedes with Ctrl+Esc). The information that appears in this bar is: - The name of the application "BirthDay" - The name of the current file (or Unnamed.CAS if you still not assign a name to the file). - An asterisk before of the name of the file if were accomplished modifications to the file (high, decreases or modifications) and yet they have not been saved. Birthday - 10 UTILIZATION - THE MAIN WINDOW The pushbuttons section: For finishing, in the lower part of the main window you has five pushbuttons: - Edit - New - Delete - Previous - Next Use the Edit button (or pulsate the key E) to edit the information of the current record in the edit window. With this you will be able to change the names, last names and the birth date of the current record. Use New (or pulsate the key N or Insert) to create a new record. In this case it will appear the edit window without name neither last name and with the date 01/01/1990. Modify this information by the adequate and pulsate Enter to accept or Esc to cancel. Use Delete (or pulsate D or Delete) to erase the current record. Upon selecting this option will be requested to your confirmation before erasing the current record. Once you selected the option and confirmed, the record will not be able be recovered. Use Previous (or pulsate S or the upward arrow) to see the content of the previous record. It does not has any effect if seeing the record number 1. Use Next (or pulsate X or the downward arrow) to see the content of the following record. It does not has any effect if seeing the last record of the current file. Keys summary of the main window: N or Insert to create a new record. E to edit the information of the current record. D or Delete to erase the current record. S or Arrow Up to see the previous record. X or Arrow Down to see the next record. Ctrl+D to see the birthday of the day. Ctrl+W to see the birthday of the week. Ctrl+M to see the birthday of the month. Ctrl+N to see the birthday of the next n days. Alt+S or Alt+G to save the current file. Alt+F to open the files menu. Alt+B to open the birthday menu. Alt+X, F3 or Alt+F4 to close the application. Birthday - 11 UTILIZATION - EDIT WINDOW The fields: The edit window is split into 5 fields: - Names - Last name - Day of birth - Month of birth - Year of birth Weigh to the name of the first two fields, you can use them for any other propose. For example: Names: Anniversary of Married of Last name: Ana y Jose Lopez or something else that you want. However, if we remain with the original objective of the program, the fields are for names and last name respectively. In the others three fields should be entered the day, month and year of the birth of the person (or well of the marriage). The date must be valid (the program confirms it) and past (can not be entered future dates). This date is indispensable! Available keys: In the Names and Last name fields you can use any character, so much letters and numbers as any other simbol. These fields accept until 32 characters (though in the main window could not see all of them). To jump of a field to the other use the key Tab (or Alt+Tab to go in opposite sense). In the fields of day, month and year of birth, you there can either, to enter the corresponding numbers, or well to use the arrows for up and for down. The years should be entered in format of 4 digit. For example 1996 (and not 96!). They are accepted years among 1900 and 2100 (but to use the year 2100 is going to must wait to arrive to him since can not be put subsequent dates to the current). Once are completed the five fields, pulsate enter to accept or the Ok button to accept, or Esc or the Cancel button to cancel. Birthday - 12 UTILIZATION - INFORMATION WINDOWS Birthday of the day: This window informs the persons of the used file that reaches years in the specified date and the quantity of years that reaches. In the title bar appears the date to the one which is made reference, in the format DD/MM/YYYY. The specified date when appears the window is the current date. However you can go to a subsequent or previous date using the Next or Previous pushbuttons or presing their first letter. The window permits to mark one line at the same time with the only one objective of seeing it better. Upon selecting Close, is closed the information window. Birthday of the Week: This window informs the persons of the used file that reaches years in the specified week, the quantity of years that fulfil and the day of the specified week in which reaches. In the title bar appears the initial and final date of the week to the one which is made reference in the format DD/MM/YYYY to DD/MM/YYYY. The used week when appears the window is the current week. However you can go to a subsequent or previous week using the Next or Previous pushbutton or presing them first letter. The window permits to mark one line at the same time with the only one objective of seeing it better. Upon selecting Close, is closed the information window. Birthday - 13 UTILIZATION - INFORMATION WINDOWS Birthday of the Month: This window informs the persons of the used file that reaches years in the specified month, the quantity of years that reaches and the day of the month in which reaches. In the title bar appears the month and the year to which is made reference in the format Month YYYY. (ie: April 1996). The used month when appears the window is the current month. However you can go to a subsequent or previous month using the Next or Previous pushbutton or presing their first letter. The window permits to mark one line at the same time with the only one objective of seeing it better. Upon selecting Close, is closed the information window. Birthday of the next n days: If you select "Next days" of the menu of the principal window or presing Ctrl+N, you arrive to a small window in the one which you must specify the quantity of days in the future in which you wish to know who reaches years. Once it introduced this number (which can not be out of the range 1 to 180), appears a similar information window to the other, unless that it does not has the Previous and Next options. If you are acceding to the information window using the parameter /P:NN this first window does not appear since you specify the quantity day in NN. Once in the information window, appear the names and last names of the persons that reaches years before happen the quantity of days specified, the age that reaches and the quantity of days that lack for their birthday. In the title bar appear the current date as well as the final date (that it is within NN days). You end this application presing the Close button just as in the others information windows. From the main window, when invokes anyone of these four information windows, these always appear, have or not information, as if might have been specified the parameter /V:Y in the command line. Birthday - 14 LEGAL NOTES Commercial character and responsibility of the author: This program is freeware, what means that you have the right of using and distributing this program so much as wants in so much not accomplishes to modification. This not gives to you right to modify it in any way. This program is provided as is. Without any implicit neither explicit guarantee of the fact that make something else that to occupy space in your hard disk. The author is not made responsible for the damages that could cause the utilization of this program (material as well as sentimental). You upon using this program assumes completes responsibility on the results of the utilization of this software. Trademark: IBM, and OS/2 are trademark of International Business Machines Corporation. Windows it is trademark of Microsoft Corporation. Birthday - 15 NOTES OF THE AUTHOR The asking: This is the first version of the program, and if God wants does not is going to be the last. As you should now by the preceding paragraphs this program is freeware, therefore you do not must pay nothing for him. However, I happened many days in front to the monitor of my computer. And if I continue improving it, I go to use many days more. Regrettably I can not give me the luxury of devoting much time, since as most of the fatal, must work. But I have the luck of working in independent form (for my same) therefore I can accommodate the schedules as more knows me. What I intend, it is that if likes you this software, sends a donation to the author with what you create that is worths the accomplished effort. Limitations: This version is limited to 450 records by file (those which I suppose will be sufficient for most users). The first year of birth that accepts is 1900 and the last 2100. Accept until 32 characters for the names and 32 for the last name. The future: This is the first version of this product, and I wait that it will not be the last. In the next versions I wait: - To add on line help. - To add an option of The Birthday from the last occupational date. - A configuration file. - Versions for DOS and Windows. - Versions in other languages (now are only available in Spanish and English). Birthday - 16 NOTES OF THE AUTHOR Mistakes and suggestions report: This is the first version of the program, therefore it is probable that has mistakes. In fact, I submitted it to numerous tests, of those which left thoroughly airy. Therefore I'm not sure that it has bugs. But no program are free. If detects some problem, sends me as soon as possible a note (by letter, E-MAIL or NetMail according to knows to you), detailing possible the best the mistake and the conditions in which is produced. In what is possible describe your equipment (processor, memory, free disk space, video card, OS/2 version, etc.). On the other hand, if has suggestions to improve the product, let me know. It does not make lack that order a donation so that I work in a suggestion. Alone makes lack that seem me reasonable and could devote time. Dedication and gratefulness: I want to devote this program to my mother and to my dad that sustain me every day, and do not disturb too much when me softly working until 4 of the morning. I want to thank to my brother Guillermo by the idea. It was occurred to him that it make this program, alone that was wanting it for Windows ... must follow waiting :-) I want to thank to my brother Eduardo by obtaining me bibliography about of the Presentation Manager, without the one which might not have been able to do nothing. And since are I thank to my brother Ricardo, so that is not put zealous ;-) I want to thank to Juan Jose Comellas by his initial support. And I want to thank to IBM by accomplishing this wonderful operating system. How to contact to the author: You can find me writing me to: Jose Indart 202 Lomas del Mirador (1752) Buenos Aires - Argentina America del Sur or by Internet E-MAIL in ajamilis@econ.uba.ar or by NetMail to 4:901/113.3 for FidoNet or 65:700/221 for EcoNet Sudamerica.